iMouse投屏 图片列表

调用说明

依赖 iMouse投屏 客户端

只在这台设备以 iMouse投屏 方式推流时可用，前置条件与 code 70~73 的含义见「iMouse投屏 相册列表」。

分页取图片列表。返回的 id 是后面「下载」「删除」要用的图片 id。

• 请求参数

参数	类型	说明	备注
fun	字符串	/plugin/imcast/photo/list	请求功能名
id	字符串	设备id	不允许多个
album_id	字符串	相册 id	来自「相册列表」，优先级高于 album_name
album_name	字符串	相册名	与 album_id 都不传时列出全部图片（按创建时间倒序）
page	整数	页码	从 1 开始，默认 1
page_size	整数	每页条数	默认 50，最大 1000
outtime	整数	超时时间	单位毫秒，不传或 0 用内核配置（默认 15 秒）

• httpGet请求示例

curl --request GET \
  --url 'http://192.168.9.9:9911/api/plugin/imcast/photo/list?id=6C:8D:C1:67:04:29&page=1&page_size=3'

• httpPost请求示例

curl --request POST \
  --url http://192.168.9.9:9911/api \
  --header "content-type: multipart/form-data" \
  --form "fun=/plugin/imcast/photo/list" \
  --form "id=6C:8D:C1:67:04:29" \
  --form "album_name=imcast测试"

• httpPost json请求示例【websocket也可发送同样json请求】

curl --request POST \
  --url http://192.168.9.9:9911/api \
  --header 'Content-Type: application/json' \
  --data '{
     "fun": "/plugin/imcast/photo/list",
     "data": {
          "id": "6C:8D:C1:67:04:29",
          "album_name": "imcast测试",
          "page": 1,
          "page_size": 50
     }
}'

响应结果

{
  "data": {
    "list": [
      {
        "id": "7181C209-321B-4BA6-9D4E-B3B88AE0AD92/L0/001",
        "file_name": "imcast_blue.png",
        "ext": "png",
        "media_type": "image",
        "size": 168,
        "width": 64,
        "height": 64,
        "index": 0,
        "create_time": "2026-09-10 14:59:56",
        "modify_time": "2026-09-10 14:59:56"
      }
    ],
    "total": 2,
    "page": 1,
    "page_size": 50,
    "has_more": false,
    "code": 0,
    "id": "6C:8D:C1:67:04:29",
    "message": "成功"
  },
  "status": 200,
  "message": "成功",
  "msgid": 0,
  "fun": "/plugin/imcast/photo/list"
}

• 响应data数据字段说明

字段	类型	说明
total	整数	符合条件的图片总数
page / page_size	整数	当前页码与每页条数
has_more	布尔值	是否还有下一页
list[].id	字符串	图片 id，「下载」「删除」用
list[].file_name	字符串	原始文件名
list[].ext	字符串	扩展名（小写）
list[].media_type	字符串	image / video
list[].size	整数	文件大小（字节），部分 HEIC / iCloud 图可能为 0
list[].width / height	整数	像素尺寸
list[].index	整数	在全量列表里的序号，从 0 起
list[].create_time	字符串	创建时间，本地时间 yyyy-mm-dd hh:nn:ss
list[].modify_time	字符串	修改时间，同上